home *** CD-ROM | disk | FTP | other *** search
/ Storm 2 / Storm II.iso / setup / stormii.vu / PULLDN3B.DOC < prev    next >
Text File  |  1990-04-21  |  35KB  |  802 lines

  1.  
  2.  
  3.    -------------------------------------
  4.      PullDown, v1.11
  5.      Released 4/21/90
  6.      (c) MicroDynamics Development 1990
  7.      All rights reserved
  8.      Shareware file: PULLDN3B.ZIP
  9.    -------------------------------------
  10.  
  11.  
  12.  
  13.   DESCRIPTION:
  14. ------------------------------------------------------------------------------
  15. A sleek professional-style pulldown menu shell for MS-DOS systems.
  16.  
  17.  
  18.   FEATURES:
  19. ------------------------------------------------------------------------------
  20.  * MS/Compatible Mouse support
  21.  
  22.  * User-defined HELP subsystem, with scrolling dialog boxes
  23.  
  24.  * Full color, background character, and screen blank timing control
  25.  
  26.  * Automatic detection of and support for Color, 25, 43, 50 line screen
  27.    modes.
  28.  
  29.  * Menus up to 8x36, or 288 selections (limited by screen mode)
  30.    with user-defined help for each selection, or any subset
  31.  
  32.  * Command line registration system permits quick upgrades
  33.  
  34.  * CRC .EXE checking provides a level of anti-virus protection
  35.  
  36.  * 100% DOS Error/Event handling, sets ERRORLEVEL on exit
  37.  
  38.  * Consultant/Dealer on-site registration system available
  39.  
  40.  * 286/386 specific version available to registered users
  41.  
  42.  * Future enhancements: Secure password subsystem, defined pathing
  43.    for .DEF and .CNF files, Automation of installation.
  44.    Bug fixes as required in under one week, if possible.
  45.  
  46.  
  47.   THE BASICS  (Advanced Users Please Skip to INSTALLATION)
  48. ------------------------------------------------------------------------------
  49. Common ground for understanding how to successfully configure PullDown is
  50. the DOS Batch Language.  It is assumed that you are at least familiar with DOS
  51. command such as CD and how to start an application.  But......
  52.  
  53. When you start an application in DOS, you usually have to change to the
  54. directory that contains the application you want to use, then start it.
  55. An example is starting Lotus 1-2-3(tm) from Lotus Development.  You likely
  56. type the following (or something close) at the C:\> (or C>) prompt...
  57.  
  58. CD\LOTUS
  59. 123
  60.  
  61. Pressing [ENTER] after each command.  All a batch file is just a little
  62. collection of keystrokes that DOS puts in for you... this saves you keystrokes
  63. and is quicker than keying all of the CD etc. commands.  To create a batch
  64. file that automates starting 1-2-3 you might type:
  65.  
  66. COPY CON 123.BAT
  67. CD\LOTUS
  68. 123
  69. [F6] [ENTER]
  70.  
  71. The [F6] function key leaves a ^Z on the screen, and [ENTER] ends the batch
  72. file.  What you just did was copy the contents of the CONsole (the screen, or
  73. what you typed in after the command...) to a FILE called 123.BAT.  After you
  74. have done this, you can type 123 [ENTER] and enter 1-2-3... you'd see this on
  75. your screen:
  76.  
  77. CD\
  78. 123
  79.  
  80. And vwolla, 1-2-3 would start.  You can do this for any application, any time.
  81. Once the batch file is created you can use it over and over again.  So, you
  82. can see why people use them.  You could also create the file 123.BAT with a
  83. text editor or a word processor in some cases.  (See notes later...)
  84.  
  85. All PullDown does is creates a batch file called TEMPPULL.BAT, based upon the
  86. DOS commands you put in a file called PULLDWN.DEF.  (DEFinition file)  The
  87. file you use to start PullDown, PULLDWN.BAT is just a collection of a couple
  88. of commands calling PullDown, then the temporary batch file.  If you think
  89. about it, the only other things the menu system needs to know are:
  90.  
  91. * The title you want displayed on the screen for the selection
  92.  
  93. * Which key will be "hot" for the selection (different color in the menu, and
  94.  by pressing that key alone the menu highlight bar will move to that
  95.  selection in the menu.)
  96.  
  97. * Which of the PullDown menus the selection will appear under.
  98.  
  99. * Which lines to totally ignore (comments)
  100.  
  101. If you have ever used WordPerfect(tm), PCSHELL(tm) in PC Tools Deluxe,
  102. Quattro/Pro, or the menu shell in DOS 4.0 you have used PullDown menus.
  103.  
  104. To facilitate defining what the menus look like, PullDown has a small set of
  105. commands you need to be familiar with.  The first is DEF.  DEF just tells
  106. PullDown that the next title is a title on the top bar of the screen under
  107. which subsequent title and batch commands will appear.  The titles are
  108. preceded by a percent symbol %, and comments you want the menu system to
  109. totally ignore are preceded by a '.  The BATCH commands used to start the
  110. application itself follow the TITLE and PullDown knows what they are only when
  111. you put a plus sign in front of them, +.  So, to create a simple three
  112. selection menu with one top bar selection that would look something like this:
  113.  
  114.   Applications
  115.  --------------
  116. | Lotus 1-2-3  |
  117. | MS Word 5.0  |
  118. | Quattro/Pro  |
  119.  --------------
  120.  
  121. The PULLDWN.DEF contents would be:
  122.  
  123. DEF
  124. %Applications
  125.  
  126. %Lotus 1-2-3
  127.  +cd\lotus
  128.  +123
  129.  +pulldwn
  130.  
  131. %MS Word 5.0
  132.  +cd\word5
  133.  +word
  134.  +pulldwn
  135.  
  136. %Quattro/Pro
  137.  +cd\qpro
  138.  +q
  139.  +pulldwn
  140.  
  141.  
  142. The last command is PULLDWN, which is the batch file that starts the PullDown
  143. menu system.  If you did not put this in as the last command, or misspelled
  144. it, you would end up at the DOS prompt instead of back in the menu system.
  145. (Installation is covered later....)
  146.  
  147.  
  148. Getting fancier, to create TWO menus with the SECOND appearing as:
  149.  
  150.  Applications   Communications
  151.                ----------------
  152.               | Qmodem 4.1B    |
  153.               | Relay Gold     |
  154.               | ProComm        |
  155.               |----------------|      << This is an non-selectable LINE,
  156.               | 3270 MainFrame |         placed in the menu for appearance.
  157.                ----------------
  158.  
  159.  
  160. You would ADD to the above .DEF file contents the following:
  161.  
  162. DEF
  163. %Communications
  164.  
  165. %Qmodem 4.1B
  166.  +e:
  167.  +cd\qmodem
  168.  +qmodem
  169.  +pulldwn
  170.  
  171. %Relay Gold
  172.  +d:
  173.  +cd\relay
  174.  +relay
  175.  +pulldwn
  176.  
  177. %ProComm
  178.  +c:
  179.  +cd\procomm
  180.  +procomm
  181.  +pulldwn
  182.  
  183. %-
  184.  
  185. %3270 MainFrame
  186.  +pc3270 t
  187.  +pulldwn
  188.  
  189. Note the use of the lone %- defined a non-selectable horizontal bar.  This is
  190. a nice feature allowing readability of long menus.  Notice also that you did
  191. NOT have to tell PullDown that the second occurrence of DEF in the file was
  192. the menu to the right, and that everything under it goes with the
  193. Communications option... this is all automatic.  Now, let's explore defining
  194. highlight keys.
  195.  
  196. A highlight key is just a key that, when pressed, moves the highlight bar to
  197. a selection.  There can only be one per selection.  If you press and hold the
  198. ALT key, then press the highlight key, the selection is made automatically.
  199. That is, it is the same as moving the highlight bar with the arrow keys and
  200. pressing enter to select a choice.
  201.  
  202. For example, to highlight the key "M" in the 3270 Mainframe selection you'd
  203. need to add a line below the title like this:
  204.  
  205. %3270 MainFrame
  206. HI=5
  207.  +pc3270 t
  208.  +pulldwn
  209.  
  210. Now, WHY 5?  The starting position is considered 0 on the 3 in 3270.  Count
  211. over 0,1,2,3,4,5 from the 3 in 3270 (ignore the %) and there is the M.
  212.  
  213.  01234567890123
  214. %3270 MainFrame
  215. HI=13                   <<<< Would highlight the e in MainFrame <
  216.  
  217. A couple of rules: HI must immediately follow the % definition, can have
  218. leading blanks, and must be valid for the selection.  If it is invalid it is
  219. ignored.  If there is more that one highlight key with the same KEY definition
  220. conflicts are resolved as the first occurrence in the menu top to bottom.  So,
  221. if the M in Qmodem (either one) AND the M in mainframe were highlighted, then
  222. if you pressed ALT+M you'd get Qmodem.  The highlights are NOT case-sensitive.
  223.  
  224. The sample file PULLDWN.DEF is a good starting point and is fully commented.
  225. A word about editing this file (and the PULLDWN.HLP file discussed below):
  226. When most commercial word processors edit a file, and you save it, they save
  227. what are known as control characters inside the file.  You never see them on
  228. your screen, but they are in the file.  Suffice it to say that what you see on
  229. screen and what is printed is NOT what is stored in the file.  The distinction
  230. is important when you start creating batch files, OR editing files that
  231. require PURE text (none of those control codes...) like PULLDWN.DEF and
  232. PULLDWN.HLP.  Just as DOS will not understand the goop that a word processor
  233. typically saves in a batch file, PullDown will not comprehend the .DEF and
  234. .HLP files a word processor saves.  There are ways to avoid this:
  235.  
  236. 1) Edit PULLDWN.DEF and PULLDWN.HLP with a text editor.  Text editors are like
  237.    word processors, but don't have fancy bold, underline, and centering
  238.    features like word processors.  They are designed to NOT save those control
  239.    characters required to make the bold, underline, etc. typefaces on your
  240.    screen or on a printer.  If you don't have one, consider the following
  241.    shareware editors:  QEDIT or ZE (Zia).  Commercially, try PE2, or PE3.
  242.    All of these products save files in a compatible, clean format.  You can
  243.    not only use them to edit the PullDown files, but to create and edit DOS
  244.    Batch files.  e.g. to create that 123.BAT file we discussed at the top you
  245.    would start a text editor, type in the commands, and SAVE the file as
  246.    123.BAT.
  247.  
  248. 2) Edit PULLDWN.DEF and PULLDWN.HLP with a word processor fully capable of
  249.    saving the file a UNFORMATTED, or ASCII.  CAUTION: Some word processors
  250.    HAVE the option but it fails to create a file with the same format as a
  251.    text editor (an example of this MS WORD 4.0).  WordPerfect, Professional
  252.    Write, and the shareware word processor PC-WRITE can save correctly
  253.    formatted files.  Beyond these, you will have to experiment.  Making backup
  254.    copies of the .DEF and .HLP files is suggested.  If you inadvertently save
  255.    a file with the wrong format, errors in PullDown operation WILL result.
  256.    Whacky menus, weird help screens, and unexpected batch commands will be the
  257.    symptoms of this.  You CAN save the file by reloading it into the word
  258.    processor that trashed it, and then save it as ASCII or UNFORMATTED text.
  259.    If that fails also, then restore your backups and edit the files with a
  260.    text editor.  [A future version of PullDown may include an editor if enough
  261.    users request it...]
  262.  
  263. Summarizing, the general format of the .DEF file is:
  264.  
  265.  DEF   - Defines a top menu bar title to follow.  Up to 8 are supported
  266.  %     - Followed by a title for the top bar
  267.  
  268.  %     - A title for a submenu, appearing under the parent DEF (above)
  269.  HI=   - Followed by the desired highlight key number, counted 0+ from left
  270.  +     - The batch commands PullDown will execute to use the program defined
  271.           by the % title preceding it.
  272.  
  273.  %-    - Puts an unselectable bar in the menu.
  274.  
  275. And so on, up to 8 DEFs, 36 %'s under a DEF (limited by your screen mode)
  276. Which brings up screen mode... if you are unfamiliar with this term, it just
  277. means the number of ROWS on your screen.  Lotus 1-2-3 Rel 2.2 and 3.0 can
  278. utilize more screen rows.  For most purposes the number of screen rows is 25,
  279. and thus your menus are limited to 23 selections, INCLUDING the unselectable
  280. bars in each.
  281.  
  282.   PULLDWN.HLP - Help Subsystem Definitions
  283. -----------------------------------------------------------------------------
  284. About the PULLDWN.HLP file.  You will notice on the PullDown menu screen that
  285. there is an [F1]=HELP key available.  This does NOT provide help on the
  286. operation of PullDown, but rather is a help screen for the selection the user
  287. has highlighted with the menu bar.  The help is user-defined, up to 50 lines
  288. long (longer available), and kept in a separate file named PULLDWN.HLP.  When
  289. you press F1, PullDown looks for this file, opens it, and then searches for
  290. the EXACT alphanumeric match to the title you have highlighted on the screen.
  291. When it is found, PullDown reads the lines beneath it until a special end of
  292. help symbol ### is detected (or until 50 lines, or end of file).
  293.  
  294. The format of the file is extremely simple.  For example, to define help for
  295. all of the menu commands created under APPLICATIONS above:
  296.  
  297. Lotus 1-2-3
  298. 1-2-3 is the leading spreadsheet.  Use it
  299. to crunch numbers, make presentation slides,
  300. or produce simple graphs.
  301. ###
  302.  
  303. MS Word 5.0
  304. Word Processing.  Use for letters, notes,
  305. memos, or even envelopes.
  306. ###
  307.  
  308. Quattro/Pro
  309. Probably the new leading spreadsheet
  310. application for professional analytic
  311. work.  Financial Analysts are already
  312. switching in droves.  Lotus Development
  313. has serious competition in this product.
  314. ###
  315.  
  316. See the section on TroubleShooting for reasons why you might get an
  317. unexpected help screen, but in brief here are the limitations:
  318.  
  319. 1) Lines must be under 69 characters (Dialog Box limitation on screen)
  320.    long.  Longer lines (up to 80 characters) are truncated.  Really long
  321.    lines, like those saved by a word processor (typically) will give you some
  322.    definitely strange results.
  323.  
  324. 2) Forgetting the ### at the end of a screen definition will result in more
  325.    help on another subject (unless it is the last one).
  326.  
  327. 3) Smiling faces and other bizarre results are certainly the control
  328.    characters saved in the .HLP file by a word processor.
  329.  
  330. Finally, how to edit the files:
  331.  
  332. Start your text editor (or compatible word processor) and LOAD the file
  333. PULLDWN.DEF.  Change it to your specifications and save it to disk.  Then,
  334. edit the file to produce help as desired (e.g. delete the leading % and +
  335. batch commands out, along with the DEFs...).  Just type in the help under
  336. each, end with ### and save the file as PULLDWN.HLP.  All done.....
  337.  
  338. Similarly, you will need to load and edit the following BATCH files...
  339.  
  340. PULLDWN.BAT
  341. MENU.BAT
  342.  
  343. Each contains simple commands that point to the directory you install PullDown
  344. in.
  345.  
  346.  
  347.   INSTALLATION
  348. ------------------------------------------------------------------------------
  349. Required expertise: Working familiarity of DOS.  You will be asked to
  350. modify some files using a text editor (NOT a Word Processor, in general)
  351. and change Autoexec.bat, if desired.  Ask for help if you do not know how
  352. to handle these tasks.
  353.  
  354. 1) UNZIP the distribution file to the directory you will install
  355.    PullDown in.  The directory does NOT need to be in your DOS PATH, but the
  356.    two batch files, MENU.BAT and PULLDWN.BAT *MUST* be.  If you are uncertain,
  357.    you may install all files in the ROOT directory of your boot drive... e.g.
  358.    C:\......
  359.  
  360. The command to install the PullDown system is:
  361.  
  362.  [D:\path\]PKUNZIP PULLDN3B.ZIP C:\INSTPTH
  363.  
  364.  where:
  365.   [D:\path] is optional, being the drive/directory PULLDN3B.ZIP is in, and
  366.   C:\INSTPTH is the drive/directory you wish to install PullDown in.
  367.  
  368.  EXAMPLE: Your PULLDN3B.ZIP file is on drive A:, and you want to install
  369.  it to C:\UTILS... type
  370.  
  371.  PKUNZIP A:PULLDN3B.ZIP C:\UTILS
  372.  
  373.  Be aware that PKUNZIP cannot create a subdirectory, so you will have to
  374.  create it first.
  375.  
  376.    This will extract and copy all of the required files to the subdirectory
  377.    of your choice.  If PullDown will be installed in a directory that is NOT
  378.    in your DOS path, an additional step is required.  (HINT: to see the
  379.    paths that are in your DOS path, type SET and press enter at the command
  380.    line....  to SET the pathing, edit your AUTOEXEC.BAT file to contain a
  381.    SET PATHS=c:\;... statement)  Copy the files MENU.BAT and PULLDWN.BAT to
  382.    a subdirectory in your DOS path, and edit them to reflect the directory
  383.    you installed PullDown into above.  Either way edit them to reflect
  384.    the subdirectory you installed the menu system in.
  385.  
  386. 2) Attempt to start the system, type PULLDWN or MENU and press enter.
  387.    You should get a dialog box on the screen.  If you don't
  388.    make sure step one was performed correctly.  PullDown traps all
  389.    error conditions such as missing files etc.  If it succeeds, you will
  390.    be presented with a dialog box requesting initialization.  Press [ENTER]
  391.    or click the <OK> command button.  PullDown detects exactly what type
  392.    of monitor and video card you have, and installs the .CNF file.  This
  393.    .CNF file contains all your options such as color etc.  It is a double
  394.    encrypted binary file, so attempting to edit it directly will only
  395.    corrupt it.  (See TROUBLESHOOTING).  After this initialization step
  396.    PullDown will display a sample menu system.  You will customize all
  397.    parts of the system in step 3.  Quit the menu system and start your
  398.    text editor.
  399.  
  400. 3) EDIT PULLDWN.DEF - Edit this file with a TEXT EDITOR ONLY.  If you
  401.    edit it with a word processor and save it, the format will be
  402.    incorrect.  The result will be junk on the screen, or worse yet
  403.    PullDown will not start at all.  (Always keep a backup)
  404.    The structure and syntax of the .DEFinition file is contained in the
  405.    header lines of the file... the example file is meant as something you
  406.    can learn from and adapt to your needs.  Suggestions:
  407.     * Edit the .DEF file, only changing the EDIT PULLDWN.DEF and .HLP
  408.       options for YOUR particular path used in setup.  Within the file
  409.       it assumes the path C:\UTILS.  Change it to your path/editor then
  410.       restart the menu system.  Select those options to edit the .DEF
  411.       file, exiting then takes you back to PullDown to see your result.
  412.     * Examine BOTH the .DEF and .HLP files before you start.  This will
  413.       show you how easy it is to add help.  IF YOU WANT TO DISABLE THE
  414.       HELP SUBSYSTEM entirely, delete the PULLDWN.HLP file and skip step
  415.       -3-.
  416.  
  417. 4) CREATE PULLDWN.HLP - This is the HELP subsystem file.  It is a parallel
  418.    file
  419.    to PULLDWN.DEF in that when you press F1 for HELP in the system PullDown
  420.    searches the .HLP file for the EXACT title heading within PULLDWN.HLP, then
  421.    displays all lines between the heading and the end of help sign ###.
  422.    Again, view PULLDWN.HLP before you attempt to create a new one so you
  423.    can see the example that came with the package.  It is strongly recommended
  424.    that you edit the .DEF file, then copy it over to form the basis of
  425.    your help file.  You will see that the formats are different in only a
  426.    minor way.  A detailed example with documentation follows.  Advanced users
  427.    might want to just skip it and edit the files right away.
  428.  
  429. 5) Optionally erase PULLDN3B.ZIP (Might serve as a good backup...)
  430.  
  431.  
  432.   USING THE KEYBOARD, MOUSE AND MENUS
  433. -----------------------------------------------------------------------------
  434. When you start the menu system, the first menu and first selection will be
  435. highlighted.  Using the keyboard, just press the up, down, left, right, home
  436. and end keys to navigate.  Press [ENTER] to select, [F1] for context help, if
  437. defined in PULLDWN.HLP, [F2] to redefine the colors, screen blank timer limit,
  438. and defaults.  The color system is self-explanatory... [F10] saves the setup,
  439. and [ESC] exits to the menus.  [ESC] from the main menu exits to DOS
  440. immediately without confirmation.  The highlighted hotkeys have a dual
  441. function.  Then pressed withOUT the ALT key held down the highlight bar moves
  442. to that selection.  When the ALT key is also held down, the selection is
  443. executed.  The MOUSE behaves as expected.  To get help using the mouse: Press
  444. the left button, drag to the selection, then instead of releasing the key roll
  445. the mouse off horizontally to the left or right.  Releasing the mouse key will
  446. then have no effect.  Click on the [F1] tag line for context help.
  447. Alternatively, drag off to one side and release the mouse button on the [F1]
  448. tagline.  Note also that this technique works on the color and exit options.
  449. It is suspected that many users will stop reading here and take off to explore
  450. the menu system.  Enjoy!  For those who want to know more, or discover how to
  451. register this software, the rest of the documentation details the .DEF and
  452. .HLP file formats and presents a short but comprehensive troubleshooting
  453. guide.
  454.  
  455.  
  456. ** This following is advanced....  see THE BASICS if you get confused **
  457.  
  458.   DETAILS ON PULLDWN.DEF and PULLDWN.HLP, WITH SAMPLE
  459. ------------------------------------------------------------------------------
  460.  
  461.   FORMAT OF PULLDWN.DEF
  462.  
  463.   ' - Anything the menu system does not understand will be ignored,
  464.       but ' denotes a clear comment.
  465.  
  466.   DEF keyword delimits the TOP ROW menu cuts.  As outlined
  467.  
  468.   %   Title.  If the first under a DEF (Max. 7 DEF @ 70 CHAR TOTAL) defines
  469.       the MAIN title.... afterward subordinate titles.
  470.  
  471.   %-  Defines a draw line.  COUNTS AS A TITLE toward the 20 MAX under each
  472.  
  473.   HI=xx  Tells the menu system which letter to highlight... default is the
  474.          first letter of the menu pick..... INVALID on the top line.
  475.  
  476.   +  Batch commands for a selection.  See documentation on maximums.  No
  477.      practical limit to the number under each.
  478.  
  479.   Leading AND trailing blanks ignored.  Case sensitive.  Be SURE DEF is caps.
  480.  
  481.   See also: PULLDWN.HLP - the user defined HELP subsystem for PULLDWN.
  482.   the best way to approach is to work out the .DEF file, then edit it
  483.   to produce the .HLP file, as PullDown EXPECTS the heading of the HELP
  484.   to be exactly the same as the title in .DEF files.... and will select
  485.   the first occurrence of the title for help.
  486.  
  487. This sample (a portion of the actual PULLDWN.DEF on the distribution disk)
  488. produces a simple menu that looks like.....
  489.  
  490.    Applications         Exit
  491.  ------------------
  492. | Quattro/Pro      |
  493. | WordPerfect      |
  494. |------------------|
  495. | Harvard Graphics |
  496. | MS Windows v3.0  |         Highlight keys not shown.....
  497.  ------------------          This is what appears on startup...
  498.  
  499. DEF
  500. % Applications
  501. ' This would be the top line.  NO HI= allowed.
  502. ' Of course, no "+" batch commands make any sense without %'s below
  503. '-----------------------------------------------------------------------------
  504. %Quattro/Pro
  505. HI=0
  506. ' Note the highlight character in the first position is 0
  507.  +echo off
  508.  +cls
  509.  +c:
  510.  +cd\qpro
  511.  +q
  512.  +PULLWN.BAT
  513. ' Always call pulldwn.bat as last menu selection to continue into menu system
  514. '-----------------------------------------------------------------------------
  515. '0123456789012345      HiLite the P in perfect....
  516. %Word Perfect 5.1
  517. HI=5
  518.  +c:
  519.  +cd\wp51
  520.  +wp
  521.  +pulldwn
  522. '-----------------------------------------------------------------------------
  523. ' The sole - on the following line makes the horizontal bar.
  524. %-
  525. '-----------------------------------------------------------------------------
  526. %Harvard Graphics
  527.  +echo off
  528.  +cls
  529.  +c:
  530.  +cd\harvard
  531.  +hg
  532.  +pulldwn
  533. '-----------------------------------------------------------------------------
  534. %Windows v3.0
  535.  +e:
  536.  +cd\win
  537.  +win3
  538.  +pulldwn
  539. ' The BETA of Windows 3.0 looks fantastic.. but slow.
  540. '=============================================================================
  541. DEF
  542. ' Second menu choice across the top.  You get 8 of these max.  Falling off
  543. ' to the right means that there are too many characters total across the top
  544. ' of the menu screen.  Reduce the length of these titles to stop that from
  545. ' happening.
  546. '-----------------------------------------------------------------------------
  547. ' Sample to create your own exit routine.....
  548. DEF
  549. %Exit
  550. '-----------------------------------------------------------------------------
  551. to DOS
  552. HI=1
  553.  +echo off
  554.  +cls
  555.  +echo Type PULLDWN [ENTER] to return to the menu system.
  556.  +echo.
  557. ' echo. will echo out a blank line.
  558. ' you could thus make it anything....
  559. ' e.g. a special logo file etc.
  560. '-----------------------------------------------------------------------------
  561. %Shell to DOS
  562.  +echo off
  563.  +cls
  564.  +echo Type EXIT [ENTER] to return.  (RAM OHD=3.5K)
  565.  +echo.
  566.  +command
  567.  +pulldwn
  568. '=============================================================================
  569.  
  570. Which is in fact pretty simple.  The HI commands, if absent, will result in
  571. the first letter of the selection being the HotKey.  Pressing a HotKey is the
  572. same as selecting it with the mouse, or with the highlight bar.  The
  573. PULLDWN.HLP file is very simple... it is just a text file of HELP, with blocks
  574. delimited by the EXACT titles above (only selections, not the top bar DEFs)
  575.  
  576. A sample .HLP file follows....  again a ' is a comment
  577.  
  578. Quattro/Pro
  579. Quattro is the latest challenger to 1-2-3, and many are switching
  580. rapidly to this system.
  581. ###
  582.  
  583. Harvard Graphics
  584. An easy to use and relatively bulletproof graphics system
  585. ###
  586.  
  587. NOTES:
  588.  * If you define no help for an option, PullDown pops a dialog box
  589.    saying so.
  590.  * The maximum line length is 69 characters, and 48 lines.
  591.    (If you need more lines, call for a custom version.)
  592.  
  593.  * The system stops at the end of the file, 48 lines, or ###, whichever
  594.    comes first.  The lines below the FIRST occurrence of the EXACT titles
  595.    as defined in PULLDWN.DEF.  Be SURE not to save long lines in this
  596.    file with a word processor.
  597.  
  598.  
  599.   TROUBLESHOOTING
  600. ------------------------------------------------------------------------------
  601. You execute PULLDWN.BAT and DOS give you 'Bad Command or Filename' - Check
  602.  your PATH definition in PULLDWN.BAT (see installation).  Or, check to be sure
  603.  PULLDWN.BAT is in a directory that IS in your DOS path.
  604.  
  605. PullDown starts, then 'Bad Command or Filename' whizzes by when you select
  606.  something.  Check the PULLDWN.DEF file contents for error under that
  607.  selections.  Most likely you have a typo in there!
  608.  
  609. No menu selections:  PULLDWN.DEF is not in the same subdirectory as
  610.  PULLDWN1.EXE, has been edited using a word processor, or does not exist.
  611.  
  612. Menu system says "no help available" but you defined help.  PULLDWN.HLP is
  613.  not in the same subdirectory as PULLDWN1.EXE, there is a spelling error
  614.  in the file (i.e. no match was found).
  615.  
  616. Help is whacky.  Duplicate string occurrences of the exact selection are
  617.  possible.  If the results are unexpected, chances are the you have two of
  618.  the same thing in the file, with the first being before the help you defined.
  619.  
  620. Help has smiling faces and bizarre characters in it.  You used a word
  621.  processor to edit the .HLP file and saved it with control characters in
  622.  it.  You can attempt to load the file again and save it without formatting,
  623.  but this at times will NOT result in a file with a CR/LF at the end, which
  624.  is what PULLDWN.HLP requires.
  625.  
  626. Help file looks OK, but truncating and weird screens are being popped in
  627.  the help box.  You have edited the file with an editor or word processor
  628.  that does not place a CR/LF at the end of each line.  Try QEDIT.
  629.  
  630. Menu system displays whacky results.  PULLDWN.HLP lines are too long (any
  631.  over 69 are truncated), it was edited using a word processor, or the file
  632.  was corrupted by some means.
  633.  
  634. PullDown starts and then displays an error message.  All error messages
  635.  are meant to be very explicit and self-explanatory.  If you get one that you
  636.  cannot understand, or the system just locks up, please call for technical
  637.  support.  (Registered or not the author will try to help)
  638.  
  639. You type PULLDWN or MENU and get "Bad command or filename" with no menu
  640.  display.  Your PULLDWN.BAT and MENU.BAT files need to be edited to
  641.  reflect the path you installed PULLDWN1.EXE and the .DEF/.HLP files in.
  642.  
  643. Results are unpredictable.  This is caused by an omission in MENU.BAT or
  644.  PULLDWN.BAT... the following sample is recommended in general... where
  645.  MENUDIR is YOUR subdirectory in which you installed PullDown:
  646.  
  647.   echo off
  648.   cls
  649.   c:                                           <<<<< YOUR DRIVE
  650.   cd\MENUDIR                                   <<<<< YOUR SUBDIR*
  651.     REM ^^^^ Substitute your subdirectory here.
  652.   pulldwn1.exe %1 %2
  653.   IF ERRORLEVEL=1 GOTO :END
  654.     REM PullDown generates an errorlevel code on exit and prints the
  655.     REM error message appropriate for the condition encountered.
  656.   temppull.bat
  657.   :END
  658.  
  659.  * It is likely the omission of this line, pointing to the subdirectory
  660.    PULLDWN1.EXE is in that may cause whacky results.  PULLDWN1.EXE
  661.    creates the TEMPPULL.BAT file.  If you have TEMPPULL.BAT files
  662.    all over your drive this is why.
  663.  
  664. PullDown starts, you select a choice, and then DON'T return to the
  665.  menu system.  Be sure you have PULLDWN or MENU as the last command in
  666.  every menu definition.  If that is true, then try putting the following
  667.  BEFORE the command to start the selection in the .DEF file...
  668.  COMMAND/C
  669.  
  670.  See the sample selection for Magellan....  some programs "clear the stack"
  671.  which means that although you execute TEMPPULL.BAT, DOS cannot find
  672.  the batch file on exit from the application.  The overhead for invoking
  673.  the second command.com by using command/c is small.
  674.  
  675. Fatal Error at ####:#### Call for tech support.  Write down the error message.
  676.  
  677. More help.  Call the tech support numbers shown in TECH SUPPORT sections
  678.  that follow.
  679.  
  680.  REQUIREMENTS:
  681. ------------------------------------------------------------------------------
  682. 256K Available RAM, DOS 3.xx (Untested under DOS 2.xx), MS or Compatible
  683. mouse optional.  Disk space requirements will vary depending upon the
  684. size of the user-defined files.  Tested on: Zenith Z series, CompuAdd,
  685. Compaq DeskPro and Portables, IBM PS/2 Models 30-70 A21, IBM AT, Austin,
  686. and IBM PC.  If the .EXE fails to start or locks your system, please
  687. notify the author.
  688.  
  689.   FILES
  690. ------------------------------------------------------------------------------
  691. PULLDWN  DEF  .......................... User-Defined menu selections
  692. PULLDWN  HLP  .......................... User-Defined Help for menu selections
  693. PULLDWN  BAT  .......................... Batch file to start menu system 1/2
  694. MENU     BAT  .......................... Batch file to start menu system 2/2
  695. PULLDN3B DOC  .......................... Documentation
  696. PULLDWN  REG  .......................... Registration Help Screen
  697. REGFORM  DOC  .......................... Registration mailer
  698. PULLDWN1 EXE  .......................... Main .EXE to run system
  699. P286     EXE  .......................... 80286+ specific version (Reg only)
  700.  
  701. Command to start PullDown is:
  702. PULLDWN [REGISTER] [HELP] [/?] or
  703. MENU [REGISTER] [HELP] [/?]
  704.  
  705.  
  706.   REGISTRATION
  707. ------------------------------------------------------------------------------
  708. The flat registration fee is $20 per copy, per machine.  Commercial operations
  709. are explicitly restrained from using this software in the unregistered state.
  710. Non-profit organizations may apply for a reduced registration fee.
  711. Individuals are bound by the unwritten "shareware" trail/registration
  712. tradition.  Please consider supporting the shareware you use and enjoy, it
  713. keeps the hobbyist going!!
  714.  
  715. Print the form REGFORM.DOC, fill it out, and send it to:
  716.  
  717.   MicroDynamics Development
  718.   1445 Mensch Lane
  719.   Gilbertsville, PA  19525
  720.  
  721. You will receive in the mail a valid registration number and name.  To
  722. validate your registration and enable advanced features simply
  723. start the menu system in a slightly different way by following the
  724. usual command with the word REGISTER.  A dialog box will appear requesting
  725. your name and registration number. Type EXACTLY what appears on the return
  726. form as the algorithm to register your copy depends upon your name.
  727.  
  728. An authorized dealer/consultant can perform all of the registration for you
  729. on-site and upon installation.  You then remit through your representative.
  730.  
  731. WHERE TO CALL FOR HELP:
  732. MicroDynamics Development consists of one person, Sam Horton, and you can
  733. reach him on the following BBS lines:
  734.  
  735.  * MicroDynamics Technical Support Conference #5, RunWay BBS
  736.    (215)-399-1328 [or (215)-399-9590 HST Private Node upon registration]
  737.    Enter the BBS by logging on and then type J;5 [ENTER]
  738.  
  739.  * GEnie: Mail address S.HORTON1
  740.  * CompuServe: Coming soon
  741.  * EXEC-PC (Subscription BBS, 100 Lines) (414)-789-4210
  742.  * Programmer's Corner (301)-596-1180 HST/2400 roll, 3 lines
  743.                        (301)-995-3744 v.32 9600, 3 lines
  744.  * DelChes BBS System  (215)-363-6625, Requires Mail-in registration, no fee.
  745.  
  746. Unless otherwise noted above, leave a message for SAM HORTON and your
  747. questions will be handled promptly.  Dealer/Consultant agreements with
  748. fee to dealer available.  Call or write for details.
  749.  
  750.   OTHER SOFTWARE
  751. ------------------------------------------------------------------------------
  752. MicroDynamics also offers XCONFIG, a menu-driven multiple boot control
  753. utility as FREEWARE (Public Domain).   An update offered as shareware will
  754. be enhanced significantly.  Coming later in 1990: ZipPak/Pro, a PKZIP(tm)
  755. shell of considerable power.  AutoHelp.BAS, a subprogram available for
  756. the QB/QBX programmer who owns DIALOGIC from Dialog Software.  (AutoHelp
  757. is used to pop the user-defined help to the screen in PullDown v1.00+)
  758. AutoHelp is a commercial product.  Write for a demo copy.
  759.  
  760.   THANKS
  761. ------------------------------------------------------------------------------
  762. To all those who encouraged the development of PullDown..........  and
  763. especially to those who registered it!
  764.  
  765.   LICENSE
  766. ------------------------------------------------------------------------------
  767. SHAREWARE LICENSE AGREEMENT ACCEPTED BY YOUR USE:  As a non-commercial
  768. private user you are permitted to use/evaluate this product at no charge
  769. for a period of 30 days.  At the end of that period, if you feel that this
  770. work has some value to you, please consider a donation of $20 to register
  771. the product.
  772.  
  773. Commercial business users are restrained from using the product in the
  774. unregistered state under ALL circumstances.
  775.  
  776. Contributing BETA TEST sites receive free registrations for their efforts.
  777.  
  778. DISTRIBUTION:  PullDown v1.11 MUST be distributed in its original, unmodified
  779. form on only public-access BBS systems.  Any distribution for remuneration
  780. beyond the cost of the diskette/mailing is strictly forbidden without the
  781. written permission of MicroDynamics and the author.  User group demo
  782. and distribution for member donation excepted.  Consultants/Dealers can
  783. obtain an on-site registration system upon acceptance of the "Dealer"
  784. agreement obtained from MicroDynamics.
  785.  
  786.   CREDIT WHERE DUE
  787. -----------------------------------------------------------------------------
  788. PKZIP(tm) PKWARE, INC 1990
  789. WordPerfect(tm) WordPerfect Corp 1981-1990
  790. MS/Microsoft MS Word et al (c) Microsoft Corp. 1980-1990
  791. Quattro/Pro(tm) Borland International
  792. Harvard Graphics (c) 1988-1990 SPC
  793. 3270 Emulation Spec (c) IBM, PE2/PE3 (c) 1984-1990 IBM
  794. And the others I might have forgotten: Please don't sue me! <grin>
  795.  
  796. Follow the motto of shareware, ENJOY!!!
  797. slh
  798. 4/90
  799.  
  800.  
  801.  
  802.